-
-
Notifications
You must be signed in to change notification settings - Fork 187
docs: Add markdoc-svelte package #1579
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
docs: Add markdoc-svelte package #1579
Conversation
This is a very useful alternative to mdsvex for rendering markdown content. The Markdoc support also enables several advantages for more advanced types of content.
@Greenheart is attempting to deploy a commit to the Svelte Team on Vercel. A member of the Team first needs to authorize it. |
I think that it would be unfortunately. There are just too many packages for us to be able to test and evaluate them all, so we have to rely on a few filters in order to select from a smaller set of packages |
While I agree that the packages should be of high quality and thus need thorough review, I think this creates an unfortunate dynamic for up-and-coming projects of high quality that would benefit from the visibility and community feedback. Encouraging the ecosystem to improve rather also makes the entire ecosystem better off. If we're not careful For Just like it's valuable to showcase a Material Design component library alongside other component libraries, adding a Markdoc package is a valuable addition to show Svelte has good support for more than Markdown. With that said, I hope you will reconsider merging this. If not, that's unfortunate but I guess we'll just have to do some marketing. And a disclaimer - I'm not the original author of Proposal for handling similar cases in the futureWhat if the This could use a GitHub issue template in the If a wider range of Svelte ecosystem projects get visibility and usage, they will benefit from feedback and development, which ultimately will help the Svelte ecosystem grow and improve faster. If we don't deal with this dynamic, this situation would risk becoming a prime example of the systems trap ![]() This should probably be a separate issue. |
markdoc-svelte
is a very useful alternative tomdsvex
for rendering markdown content. The Markdoc support also makes it easier to create advanced types of content, like composable blocks for website builders and documentation sites.After successfully using
mdsvex
for many years, my team has found an even better solution and started usingmarkdoc-svelte
in several projects lately. This has enabled much more flexibility for dynamic content, compared to MDSveX and MDX. In addition,markdoc-svelte
has better support for layouts, TypeScript, metadata, and Svelte 5 compared tomdsvex
.I hope a low download count is not a blocker for adding new, high quality packages like this one.
I'm not sure about the optimal order, but think it makes sense to showcase early since markdown and similar content types are very common. Perhaps this could even be added as number 2 or 3 to be visible above the fold, since the package is a solid alternative to
mdsvex
.Before submitting the PR, please make sure you do the following
feat:
,fix:
,chore:
, ordocs:
.